SGPanelInstall(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 7 - Sequence Grabber Panel Components / Sequence Grabber Panel Components Reference

Functions / Managing Your Panel Component

SGPanelInstall
A sequence grabber component calls your SGPanelInstall function after adding your items to the settings dialog box, just before it displays the dialog box to the user.
pascal ComponentResult SGPanelInstall (SeqGrabPanelComponent s, 
                                        SGChannel c, DialogPtr d,
                                        short itemOffset);
s
Identifies the sequence grabber component's connection to your panel component.
c
Identifies a connection to the sequence grabber channel associated with your panel component.
d
Contains a dialog pointer identifying the settings dialog box. Your component may use this value to manage its part of the dialog box.
itemOffset
Specifies the offset to your panel's first item in the dialog box. Because sequence grabber components build your dialog items into a larger dialog box containing other items, this value may be different each time your panel component is installed; do not rely on it being the same.

DESCRIPTION
A sequence grabber component calls your SGPanelInstall function just before displaying the dialog box to the user. The sequence grabber provides you with information identifying the channel that your panel is to configure, the dialog box, and the offset of your panel's items into the dialog box. You may use this opportunity to set default dialog values or to initialize your control values.

SEE ALSO
Sequence grabber components call your component's SGPanelRemove function before they remove your panel from the settings dialog box. That function is discussed next.